'.\" t
.TH "send_arp" "1M" "Jun 28, 2006" "1\&.2\&.0"
.SH NAME
send_arp \- Broadcast Gratuitous ARP Packet

.SH SYNOPSIS
.TS
l.
send_arp ip mac broadcast FF:FF:FF:FF:FF:FF card
         - Broadcast Gratuitous ARP packet
.TE

.SH DESCRIPTION
Current versions of Linuxha.net have a inbuilt Perl module to
provide the same functionality as this tool. However, if for 
whatever reason, that module is not available, (i.e. failed to build
as part of the package installation), then this binary is used as
a fall-back.

A gratuitous ARP request ensures that clients with IP address on the
same physical subnet as the server are made aware of IP fail-over between
different network cards on the same server.

.SH ARGUMENTS
When using this utility for Linuxha.net functionality all arguments are 
mandatory, and consist of:

.TP 4
.B ip
The IP address that will be related to the ARP address on the
specified card.
.TP
.B mac
This is the MAC address on the card which will be used for the
specified IP address - and differs for all Cards. 
.TP
.B broadcast
The broadcast IP address for the interface card in question to
ensure this packet is sent to all hosts in the local subnet.
.TP
.B FF...
This is a hard-coded value and represents the ARP address that will
ensure all local clients on the network refresh their ARP caches
with the correct MAC address for this IP address currently.
.TP
.B card
The actual Ethernet card that will be used for the application
IP address - such as "eth2".

.SH EXIT STATUS
The program will use the following return codes:

.TP 4
.B 0
The program successfully sent out the Gratuitous ARP packet successfully.
.TP
.B 1
An error occurred - message information can be found on standard error.

.SH SEE ALSO
.TS
l l.
cldeamon(1M)	- Cluster status Daemon
appconf.xml(5)	- Application configuration file
clconf.xml(5)	- Cluster Configuration file
.TE

.SH AUTHOR
The \fIsend_arp(1M)\fP utility was written by Yuri Volobuev
and is freely available (no license has been applied).

.SH AVAILABILITY
This software is freely available from the following URL, which
also describes how the tool can be used fully:

.TS
l.
http://www.insecure.org/sploits/arp.games.html
.TE

